home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / MONITOR / HCSHOW10.ARJ / HCSHOW.DOC next >
Text File  |  1992-04-08  |  9KB  |  256 lines
  1.  
  2.  
  3.               H C   S H O W
  4.  
  5.                Version 1.0b
  6.               April 4, 1992
  7.  
  8.     A Targa(tm) and GIF(tm) Viewer for Tseng(tm) HiColor(tm) Cards
  9.  
  10. Copyright 1990,1991,1992 Synergrafix Consulting.  All Rights Reserved
  11.  
  12.      HCSHOW is produced by:
  13.  
  14.        Steve Enns            Synergrafix Consulting
  15.     2425 Haultain Ave.        - Custom Programming
  16.       Saskatoon, Sk.          - Graphical and Numerical Software
  17.       Canada S7J 1R2          - Hardware and Software Consultation
  18.  
  19.  
  20.     Donations gratefully accepted!  $10.00 will get you the latest
  21.     version of this program on disk!  Don't make me hunt you down
  22.     like a dog to scream shareware licenses into your face!
  23.  
  24.  
  25.     This program is dedicated to all those unemployed ray-tracing
  26.     artists out there who have the talent, skill (and time ;) to
  27.     create truly amazing images out of pixels and imaginary light.
  28.     (Miller and Brown - come to town, I'll buy you a beer - not 
  29.     tomorrow though, I'm washing my hair.)
  30.  
  31.  
  32. ACKNOWLEDGEMENTS
  33.  
  34.      Thanks to all the contributors to the absolutely superb graphics
  35.      books:
  36.  
  37.     Graphics Gems    Academic Press, Edited by Andrew S. Glassner, 1990,
  38.             ISBN 0-12-286165-5
  39.  
  40.     Graphics Gems II  Academic Press, Edited by James Arvo, 1991,
  41.               ISBN 0-12-064480-0
  42.  
  43.      Thanks as well to some greatly inspirational and explicit code
  44.      by Michael Abrash in the November 1991 Doctor Dobbs Journal.
  45.  
  46.      Finally, great thanks to Daniel Lee Crocker and the Stone Soup
  47.      Group for numerous tremendous contributions to the public good
  48.      through PICLAB, and FRACTINT (the best program ever written) both
  49.      containing very enlightening Targa(tm) file code.
  50.  
  51.      Thanks also to John Swenson who wrote TGVIEW, which encouraged me
  52.      to write this much faster and better program. ;-)
  53.  
  54.      Trademarks like GIF(tm) and PC(tm) are held by
  55.      their respective companies.
  56.  
  57.  
  58. DISCLAIMER
  59.  
  60.      The HCSHOW program is provided without warranty of any kind.  The
  61.      user of the HCSHOW package assumes complete responsibility for
  62.      any and all incidental or consequential damages which may occur
  63.      during normal or abnormal use of the HCSHOW package.  Use the
  64.      HCSHOW program at your own risk.
  65.  
  66.  
  67. LICENSE
  68.  
  69.      The HCSHOW program and documentation are Copyright 1990,1991,
  70.      1992  Synergrafix Consulting.  All rights reserved.  The HCSHOW
  71.      program may be freely distributed to others by any means, as
  72.      long the following (three) conditions are met:
  73.  
  74.       1) HCSHOW is distributed in a "package" containing
  75.       the following files:
  76.  
  77.         HCSHOW.EXE
  78.         HCSHOW.DOC
  79.         HCSREAD.ME
  80.  
  81.       2) HCSHOW is not distributed as part of any other
  82.       product, except with specific written permission from
  83.       the authors.
  84.  
  85.       3) NO fee of any kind is charged for the HCSHOW
  86.       package or for the service of providing the package,
  87.       except Computer Bulletin Board Systems or Services,
  88.       which may distribute the HCSHOW package even though they
  89.       may charge a membership or service fee.
  90.  
  91.  
  92.      Look for the HCSVGA library on your favorite bulletin board
  93.      system.  The HCSVGA has the Targa(tm), GIF(tm) and HiColor
  94.      support used by HCSHOW.
  95.  
  96.      (If you are seriously interested in the source code for the
  97.      HCSVGA library, then write me a letter with your proposed uses
  98.      for the code, and I'll return a quote for the price.  (Probably
  99.      $50.00-$100.00 with no royalties.)
  100.  
  101.  
  102. REQUIREMENTS
  103.  
  104.       HCSHOW requires the following:
  105.  
  106.            -    PC(tm)/XT(tm)/AT(tm)/386(tm) computer
  107.            -    TSENG 4000 based Video Card equipped with
  108.             at least 1 Megabyte of display memory, and
  109.             a Sierra HiColor(tm) DAC chip
  110.  
  111.       Optionally:
  112.  
  113.            -    A MS compatible mouse for the incredibly
  114.             confusing "Cursor Mode"
  115.  
  116.  
  117. USAGE
  118.  
  119.  
  120.      HCSHOW filespec[.GIF|.TGA] [outfilename[.TGA]] /dither /comp
  121.         /autoscale /mode=0..3 /text=str /giftag=giffile /comm=str
  122.         /nocomm /info /slide=n
  123.  
  124.      where:
  125.  
  126.     filename     - the Targa(tm) or GIF(tm) to display.
  127.     outfilename    - the Targa output filename (used to save dithered
  128.                 pics, see below.)
  129.     /dither        - dither the image if it is a 24 or 32 bit Targa(tm)
  130.     /comp        - compress the output Targa(tm) file
  131.     /autoscale    - try to scale the GIF(tm) to fit the screen
  132.     /mode=n        - force mode n.  Not all modes work with all cards.
  133.     /text=str    - display "str" when placing text in cursor mode.
  134.     /giftag=filename - display GIF "filename" when placing a GIF in
  135.                 cursor mode.
  136.     /comm=str    - display comment "str", and add it to the Targa when
  137.                 saving.
  138.     /nocomm        - don't display the Targa comment on the screen. (A
  139.                 comment can still be placed in the Targa
  140.                 with /COMM=str
  141.     /info        - display file information on the screen.
  142.     /slide=n      - do a slideshow of the specified files, waiting n
  143.                 seconds between each picture.
  144.  
  145.  
  146. EXAMPLES
  147.  
  148.      HCSHOW is very easy to use.  When the picture is displayed, press
  149.      <ENTER> to save the current display as a Targa-16(tm), press "C"
  150.      to enter "cursor mode" (see below) or any other key to exit without
  151.      saving.
  152.  
  153.      C> HCSHOW picname
  154.  
  155.      will display "picname" on the screen in HiColor mode.  Looking
  156.      for "picname.gif" first, and then "picname.tga".
  157.  
  158.      or
  159.  
  160.      C> HCSHOW picname out.tga /dither /comp /mode=3
  161.  
  162.      will display "picname" using dithering and 800x600 mode, saving
  163.      the output (if any) to the file "out.tga"
  164.  
  165.      or
  166.  
  167.      C> HCSHOW a*.tga /dither /comp /mode=3 /text=Copyright~1992~SE
  168.         /giftag=mylogo.gif /comm=Copyright~1992~SE
  169.  
  170.      will display all the files "a*.tga", dithering when displaying
  171.      24 or 32 bit Targas, using 800x600 mode and placing the text
  172.      "Copyright 1992 SE" on the screen when using "cursor mode", and
  173.      into the Targa as a comment when a screen is saved....
  174.  
  175.  
  176. CURSOR MODE
  177.  
  178.      Sorry, I'm going to leave this explanation in its current in-
  179.      comprehensible state until I decide the future of this program.
  180.      In the meantime, have a stiff drink, and just read through it
  181.      really fast without stopping, and it will seem really obvious,
  182.      just like proofs from your graph theory class...
  183.  
  184.         Press "C" when a picture is displayed to enter cursor mode.
  185.      If you have a mouse (and mouse driver software) installed, you
  186.      will have a graphical cursor available to define rectangular areas
  187.      of the current screen image.  Press and hold the left mouse button
  188.      to start "dragging" a box to the desired size.  Release and re-press
  189.      the left button to restart another box.  Upon choosing a suitable
  190.      area with the "dragging box", press <ENTER> to use the current box
  191.      area for further operations, or press <ESC> to ignore the chosen box,
  192.      and return to the whole screen.  Both <ENTER> and <ESC> exit cursor
  193.      mode, and return to normal operation.  If you chose a box and pressed
  194.      <ENTER> you can now save the area within the box by pressing <ENTER>
  195.      again, or you can press <ESC> to exit or <SPACE> to go to the next
  196.      picture, if there is one.  So there.
  197.         Press the right mouse button when moving the mouse to activate
  198.      the text (specified with /TEXT=str).  This text can now be placed on
  199.      the screen by pressing the right mouse button when you are satisfied
  200.      with the position.  Press "G" when moving the cursor to display the
  201.      GIF (specified with /GIFTAG=giffile) a the current position.  This
  202.      feature is intended to allow placement of graphical logos saved as
  203.      GIFs onto Targa images as a "signature."
  204.         If you want to wreck the image, you can also press "I" to invert
  205.      the colours in the current area, or "r" "R" "g" "G" "b" "B" to
  206.      decrease or increase the red green or blue components of the colours
  207.      in the current area.
  208.  
  209.  
  210. HISTORY
  211.  
  212.      - Version 0.5b Completed December 20 1991
  213.  
  214.     Just a Beta version!  Lots more to be done...
  215.  
  216.      - Version 0.6b February 4 1992
  217.  
  218.     Output filenames are now properly recognized.  Maybe.
  219.  
  220.     Now compiled with Borland C 3.0 for extra speed,
  221.     especially when dithering Targa-24 files.
  222.  
  223.      - Version 1.0b April 4 1992
  224.  
  225.     Dithering of Targa-24's is faster still (Displays/dithers
  226.     3 times faster than TGVIEW...Hear that John Swenson?!)
  227.  
  228.     Wildcard input filenames, slideshows and all kinds of
  229.     other new crap.  (I decided to add a bunch of bugs instead
  230.     of waiting for people to find them.)
  231.  
  232.  
  233.  
  234. PROPOSED FUTURE ENHANCHMENTS
  235.  
  236.      - I would like samples of Targa(tm) files (or GIFs) which
  237.      do not display properly when viewed with HCSHOW.
  238.  
  239.      - Support for other graphics hardware.  Hopefully, we will
  240.      be able to support new hardware and graphics modes as they
  241.      are introduced.  I will try to support the ATI VGAWonder XL(tm)
  242.      if someone sends me some fairly explicit code demonstrating
  243.      how modes are set, and memory banks are switched.
  244.  
  245.      - Faster GIF(tm) and Targa(tm) decoding and encoding
  246.  
  247.      - Quantizing Targa(tm) images to be saved as GIF(tm)
  248.  
  249.      - All kinds of editing, and picture tuning features.
  250.  
  251.      - Real Documentation!  Not a priority, but I'm sure you
  252.     guessed that.
  253.  
  254.  
  255.  
  256.